feat(swift-ios): embed an exact build changelog with links by saphid · Pull Request #5969 · pingdotgg/t3code

saphid · 2026-08-10T08:17:44Z

Summary

Embeds a bounded offline changelog for Debug device installs and shows exact commits in Settings with commit and detected PR links. Generation is compact, portable across remotes, best-effort without Git history, and independent of the older version-settings PR.

Verification

apps/swift-ios/Scripts/ci-test.sh — 220 tests passed; generator tested with real and missing Git history
Fresh independent Claude Opus 5 high review completed; all actionable findings were addressed and the final repair review found no blockers.
Simulator visual evidence will be attached before marking this PR ready for review.

Scope

Targets the active native SwiftUI owner branch (#5178).

Note

Embed a git-based build changelog in the iOS app's Settings screen

Adds a Swift script (generate-build-changelog.swift) that extracts commits between a base ref and HEAD, builds PR links from commit titles, and writes a size-limited JSON file (48 KiB cap, oldest entries dropped first).
The install-device.sh build script base64-encodes the JSON and injects it into the app bundle via the T3_BUILD_CHANGELOG build setting for Debug device builds.
A new BuildChangelog model decodes the base64 JSON from Info.plist at runtime, exposing short commit hashes and deduplicated entry summaries.
A new BuildChangelogView renders the latest change, earlier changes in a timeline, and commit/PR links; empty states are shown when no changelog is embedded or no diffs exist between revisions.
The Settings About section now displays the app version string and a "Build changelog" navigation row.

^{Macroscope summarized 1e1f4a9. (Automatic summaries will resume when PR exits draft mode or review begins).}

Note

Low Risk
Settings-only UI plus optional Debug build metadata; no auth, networking, or release-path behavior changes.

Overview
Adds an offline build changelog for native SwiftUI Debug device installs: commits since a configurable base ref are embedded at build time and surfaced in Settings → About.

Build pipeline: generate-build-changelog.swift walks git log between T3_SWIFT_CHANGELOG_BASE_REF (default upstream/t3code/rebuild-mobile-app-swift) and HEAD, parses PR numbers from titles, caps payload size (~48 KiB), and writes JSON. install-device.sh runs this only for Debug, base64-encodes the result into T3_BUILD_CHANGELOG, and passes it through Info.plist as T3BuildChangelog.

In-app: BuildChangelog decodes the embedded payload; Build changelog in About shows version/build via SettingsAboutMetadata, highlights the latest commit, lists earlier changes on a timeline, and links to commits/PRs when a repo URL is available. Empty or missing changelog states are handled explicitly.

Tests cover version labeling, changelog decode, and summary deduplication; README documents T3_SWIFT_CHANGELOG_BASE_REF.

^{Reviewed by Cursor Bugbot for commit 1e1f4a9. Bugbot is set up for automated code reviews on this repo. Configure here.}

coderabbitai · 2026-08-10T08:18:03Z

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 14f5d6f8-a766-4457-b14a-047b491b67f4

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

saphid · 2026-08-10T08:50:10Z

Simulator evidence from the integrated approved Debug build (the exact PR head is covered by the passing native CI job):

Verified in the iOS 26.5 simulator: the embedded changelog decoded, displayed both build entries, and exposed actionable commit and PR links.

cursor

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit cb69786. Configure here.}

macroscopeapp · 2026-08-10T09:38:03Z

Approvability

Verdict: Needs human review

This PR introduces a new feature with new user-facing UI (build changelog view in Settings), new data models, new build scripts, and workflow changes. While well-structured and tested, new features with this scope warrant human review.

^{You can customize Macroscope's approvability policy. Learn more.}

saphid · 2026-08-10T14:02:44Z

Final dependency-safe changelog is preserved at saphid/swiftui-changelog-final-stack (71a07b1c9), one clean commit on the composed release/debug integration head. Do not force-update this Theo-targeted PR yet: its tested base includes open #5790 → #5970 → #5972 → rebuilt #5789. Updating now would duplicate those diffs.

Unique behavior reuses #5790 formatting; accepts notes only when embedded version/build match the installed app; shows explicit Unavailable otherwise; sanitizes credentials/jargon; bounds metadata; keeps Release free of local Git history; and composes generation after the cleanup trap while preserving monotonic validation/debug metadata/build order.

Verification: changelog/install composition + monotonic + debug shell suites pass; focused Settings 6/6; Debug run; Release build with empty changelog; full native 103 XCTest + 236 Swift Testing, one expected skip, zero failures; git diff --check clean. Tailnet-only proof: https://alexs-macbook-pro-1.tail4e5636.ts.net:10015/changelog-final-proof.mp4

Conflict classification: feature complementary, code/history conflicting because old #5969 duplicates version rows/formatter and overlaps Info.plist/install ownership. Landing order: #5790 → #5970 → #5972 → unique #5789 5230a96b4 → unique changelog 71a07b1c9; then update this PR. Opus review unavailable at confirmed 429; no verdict claimed.

saphid · 2026-08-11T10:55:36Z

Exact final-head simulator proof (f499549): the embedded changelog presents the latest change, earlier entries, build revision, and bounded timeline at phone width.

Focused settings tests passed (3/3); the generated fixture contained 7 entries, omitted 0, and stayed at 1088 bytes. The current native-CI red is the base-branch provider-catalog fixture failure fixed separately in #6130.

github-actions Bot added vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. size:L 100-499 changed lines (additions + deletions). labels Aug 10, 2026

saphid marked this pull request as ready for review August 10, 2026 09:26

cursor Bot reviewed Aug 10, 2026

View reviewed changes

Comment thread apps/swift-ios/Scripts/generate-build-changelog.swift

Comment thread apps/swift-ios/Features/Settings/BuildChangelog.swift

saphid marked this pull request as draft August 10, 2026 14:44

saphid added 8 commits August 11, 2026 19:20

feat(swift-ios): show exact build changelog in app

85e2dbc

feat(swift-ios): link changelog commits and pull requests

a38082d

fix(swift-ios): keep changelog independent of version settings

ceb6c2f

fix(swift-ios): make embedded changelog upstream-safe

106e2b8

fix(swift-ios): bound portable changelog generation

5ebaec3

fix(swift-ios): tolerate unavailable git metadata

a88b531

fix(swift-ios): clarify embedded changelog entries

f604156

fix(swift-ios): harden embedded changelog

f499549

saphid force-pushed the saphid/swiftui-changelog-v2 branch from 1e1f4a9 to f499549 Compare August 11, 2026 10:26

Navigation Menu

Uh oh!

feat(swift-ios): embed an exact build changelog with links - #5969

feat(swift-ios): embed an exact build changelog with links#5969
saphid wants to merge 8 commits into
pingdotgg:t3code/rebuild-mobile-app-swiftfrom
saphid:saphid/swiftui-changelog-v2

saphid commented Aug 10, 2026 •

edited by macroscopeapp Bot

Loading

Uh oh!

coderabbitai Bot commented Aug 10, 2026 •

edited

Loading

Review skipped

Uh oh!

saphid commented Aug 10, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Uh oh!

macroscopeapp Bot commented Aug 10, 2026 •

edited

Loading

Uh oh!

saphid commented Aug 10, 2026

Uh oh!

saphid commented Aug 11, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

saphid commented Aug 10, 2026 • edited by macroscopeapp Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Verification

Scope

Embed a git-based build changelog in the iOS app's Settings screen

Uh oh!

coderabbitai Bot commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

saphid commented Aug 10, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

macroscopeapp Bot commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Approvability

Uh oh!

saphid commented Aug 10, 2026

Uh oh!

saphid commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

saphid commented Aug 10, 2026 •

edited by macroscopeapp Bot

Loading

coderabbitai Bot commented Aug 10, 2026 •

edited

Loading

macroscopeapp Bot commented Aug 10, 2026 •

edited

Loading

saphid commented Aug 11, 2026 •

edited

Loading